<!DOCTYPE html>
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<title>MailPress &rsaquo; ReadMe</title>
	<link rel="stylesheet" href="mp-admin/css/readme.css" type="text/css" />
</head>
<body>
<h1 id="logo" style="text-align: center">
	<img alt="MailPress" src="mp-includes/images/logo_lmailpress_admin.png" />
	<br /> Version 5.3
	<br /><form action="https://www.paypal.com/cgi-bin/webscr" method="post"><input type="hidden" name="cmd" value="_s-xclick" /><input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----" /><input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!" /><img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1" /></form>
</h1>
<p style="text-align: center">the WordPress mailing platform</p>

<h1>First Things First</h1>
<p>Welcome. MailPress is a very special project to me and I'm proud to be a part of it ;-). Lot of hours have gone into MailPress, and I am dedicated to making it better every day. Thank you for making it part of your world.</p>
<p style="text-align: right;">&#8212; Andr&eacute; Renaut</p>

<p style='color:red;'><strong>If Upgrading, please read the Upgrading section.</strong></p>


<h1>System requirements</h1>
<ul>
	<li>PHP version <strong>5.2</strong> or higher.</li>
	<li>MySQL version <strong>5.0</strong> or higher.</li>
	<li>WordPress version <strong>3.4</strong> or higher.</li>
</ul>
<p>
	MailPress 5.3 is using <a href="http://www.swiftmailer.org/">swiftmailer 4.1.7</a>.
	<br />
	 </p>

<h1>Installation</h1>
<ol>
	<li> Make sure you have already installed WordPress 3.4 or above.</li>
	<li> Unzip the MailPress package.</li>
	<li> Upload the <code>mailpress</code> folder into <code>wp-content/plugins</code>.</li>
	<li> Make sure the <code>wp-content/plugins/mailpress/tmp</code> folder is writable.</li>
	<li> Log in to your WordPress admin and point your browser to "Plugins" page.</li>
	<li> Activate MailPress plugin.</li>
	<li> Point your browser to "Plugins > MailPress Add-ons" and activate required/desired add-ons.</li>
	<li> Point your browser to "Settings > MailPress", fill and save the settings for each tab (General, Connection to your mail server, Test, ... add-ons).</li>
	<li> Once everything is installed, use the Test tab in "Settings > MailPress" to validate your settings.</li>
</ol>

<h1>Upgrading</h1>
<p><b>Never use WordPress automatic upgrade</b> : if you have any customized file, WordPress will delete them !</p>
<ol>
	<li>Point your browser to "Plugins &gt; MailPress Add-ons" page and deactivate all add ons.</li>
	<li>Point your browser to "Plugins" page and deactivate MailPress plugin.</li>
	<li><span style='color:red;'><strong>If you have any customized file</strong></span>, Save or Back-up <code>mailpress/tmp</code> folder + your MP theme + any customized file : In 5.3
		<ul>
			<li>standards newsletters xml files have their path changed : <code>mailpress/mp-content/advanced/newsletters/post/</code> (formerly <code>mailpress/mp-content/advanced/newsletters/</code>)</li>
			<li>post newsletter xml file has its path & name changed : <code>mailpress/mp-content/advanced/newsletters/post/post.xml</code> (formerly <code>mailpress/mp-content/advanced/newsletters/new_post.xml</code>)</li>
			<li>category newsletters xml file(s) have their path changed : <code>mailpress/mp-content/advanced/newsletters/post/categories</code> (formerly <code>mailpress/mp-content/advanced/newsletters/categories</code>)</li>
			<li>scheduler id <code>post_cat</code> is renamed in <code>post_category</code></li>
			<li>processor id <code>now</code> is renamed in <code>post</code></li>
		</ul>
	</li>
	<li>Delete <code>wp-content/plugins/mailpress</code> folder.</li>
	<li>Unzip the MailPress package.</li>
	<li>Upload the mailpress folder into <code>wp-content/plugins</code>.</li>
	<li>Make sure the </code>wp-content/plugins/mailpress/tmp</code> folder is writable.</li>
	<li>Restore <code>mailpress/tmp</code> folder + your MP theme + any customized file (read step 3 for any <code>mailpress/mp-content/advanced/newsletters/</code> restore)</li>
	<li>Refresh "Plugins" page and activate MailPress plugin</li>
	<li>Activate MailPress previous add-ons (Plugins &gt; MailPress Add-ons)</li>
</ol>
<p>MailPress themes and templates do not need to be changed if customized in a previous MailPress release. </p>
<p><b>Never use WordPress automatic upgrade</b> : if you have any customized file, WordPress will delete them !</p>

<h1>Upgrading from another system</h1>
<p>
	MailPress can import the emails stored in another system.<br />
	First you need to get MailPress installed and working as described above.<br />
	To finally import your emails into MailPress, you will need to use the <code>Import</code> add-on.<br />
	You have developped your own importer and you think it can be useful to the MailPress community, let us know.
</p>

<h1>Resources</h1>
<p>If you have any questions that aren't addressed in this document, please take advantage of MailPress numerous online resources:</p>
<dl>
	<dt><a href="readme.txt">Readme.txt</a></dt>
		<dd>Read the <code>readme.txt</code> of MailPress</dd>
	<dt><a href="http://www.mailpress.org/wiki">Plugin wiki</a></dt>
		<dd>Bookmark and check often.</dd>
	<dt><a href="http://groups.google.com/group/mailpress">MailPress google group </a></dt>
		<dd>The MailPress google group. See the <a href="http://groups.google.com/group/mailpress/web/welcome-page">Welcome page</a>.</dd>
</dl>

<h1>Some Add-ons</h1>
<ul>
	<li>
		<h2>Comment</h2>
		<p>MailPress' subscribe to comments : <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Comment'><code>Comment</code></a>.</p>
	</li>
	<li>
		<h2>Newsletters</h2>
		<p>Allow subscription to newsletters. Newsletters are initialized with <code>mailpress/mp-content/advanced/newsletters</code> allowing you to fully customize each newsletter (theme, template, schedule ...) : <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Newsletter'><code>Newsletter</code></a>.</p>
	</li>
	<li>
		<h2>Mailing lists</h2>
		<p>Need to organize the emails inserted into MailPress and/or let your users to choose which mailing lists they subscribe to, based on WordPress taxonomy concept (post categories, link categories, tags) : <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Mailinglist'><code>Mailinglist</code></a>.</p>
	</li>
	<li>
		<h2>Batch mode</h2>
		<p>Your website becomes more and more successful, you have now plenty of subscribers, processing a large number of recipients becomes an issue ! , use the <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Batch_send '><code>Batch_send</code></a> add-on.</p>
	</li>
	<li>
		<h2>Bounce handling</h2>
		<p>Process your mail bounces with <a href="http://www.mailpress.org/wiki/index.php?title=Add_ons:Bounces"><code>Bounce_handing</code></a> add-on.</p>
	</li>
	<li>
		<h2>Tracking</h2>
		<p>Track your mails will report opening rate, clicks generated as well as geolocations of your readers using the MailPress Ip api. Activate <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Tracking'><code>Tracking</code></a> add-on.</p>
	</li>
	<li>
		<h2>Synchronize with WordPress</h2>
		<p>You want to synchronize MailPress with your WordPress registered users, <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Sync_wordpress_user'><code>Sync_wordpress_user</code></a> add on is made for you.</p>
	</li>
	<li>
		<h2>User Roles</h2>
		<p>If you need to set Capabilities in MailPress, use the <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Roles_and_capabilities'><code>Roles_and_capabilities</code></a> add-on.<br /> You can read more about <a href="http://codex.wordpress.org/Roles_and_Capabilities">Roles and Capabilities</a> on the Codex.</p>
	</li>
	<li>
		<h2>SMTP, Sendmail, PHP mail()</h2>
		<p>Natively, MailPress support SMTP connections to your mail server, however you can switch to Sendmail <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Sendmail'><code>Connection_sendmail</code></a> or native php mail() <a href='http://www.mailpress.org/wiki/index.php?title=Add_ons:Phpmail'><code>Connection_phpmail</code></a>.</p>
	</li>
</ul>


<h1> Final notes</h1>
<ul>
	<li>If you have any suggestions, ideas, comments, or if you (gasp!) found a bug, join the MailPress community in the <a href="http://groups.google.com/group/mailpress">MailPress google group</a>.</li>
	<li>WordPress now has a robust plugin API that makes extending MailPress code easy. If you are a developer interested in utilizing this see the <a href="http://codex.wordpress.org/Plugin_API">plugin documentation</a> in the Codex. In most all cases you shouldn't modify any of the core code.</li>
</ul>

<h1>Share the Love</h1>
<p>MailPress has no multi-million euro marketing campaign or celebrity sponsors, but do have something even better&#8212;you. If you enjoy MailPress please consider telling a friend, setting it up for someone less knowledgable than yourself, or writing a post on MailPress.</p>


</body>
</html>
